home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 27.zip / BS1 part 27 / HiSoftBasicD1.adf / Libinfo < prev    next >
Text File  |  1993-07-29  |  2KB  |  60 lines
  1.  
  2.  Library-Aufrufe 
  3.  ---------------
  4.  
  5.  Hier liegt die Quelle der Verwirrung für viele Anwender.
  6.  Mit Library-Aufrufen meinen wir den Aufruf von Routinen aus 
  7.  Amiga-Libraries, wie z.B. Intuition, Grafik oder DOS. 
  8.  HiSoft Basic ist zu 99% kompatibel mit dem AmigaBasic-Interpreter 
  9.  und im Gebrauch von Libraries.
  10.  
  11.  Um eine Library aufzurufen, brauchen Sie eine .bmap-Datei,
  12.  die mit dem Programm "convertfd" auf der Extras-Disk
  13.  erzeugt werden kann; allerdings sind bequemlichkeitshalber 
  14.  alle gebräuchlichen .bmap-Dateien im Verzeichnis .libs: 
  15.  auf Disk 1 enthalten. 
  16.  Die .bmap-Dateien werden nur zur Kompilierzeit gebraucht,
  17.  und nicht dann, wenn das kompilierte Programm abläuft. 
  18.  Zusätzlich ist auf Disk 2 eine modifizierte 
  19.  convertfd.bas-Quelldatei enthalten.
  20.  
  21.  Der erste Schritt zum Gebrauch von Libraries liegt darin, 
  22.  die gewünschte Library anzugeben. Dies geschieht in der 
  23.  LIBRARY-Anweisung. Danach werden mit DECLARE-Anweisungen 
  24.  Funktionen definiert, wie z.B. in
  25.  
  26.   LIBRARY "dos.library"
  27.   DECLARE FUNCTION SetComment&(nameptr&,comment&) LIBRARY
  28.  
  29.  Dies bedeutet, daß die DOS-Library gebraucht wird und 
  30.  SetComment eine Funktion ist. Beim Fehlen von DECLARE 
  31.  würde angenommen, daß SetComment eine Prozedur ist 
  32.  (d.h. besitzt kein Return-Ergebnis).
  33.  
  34.  Der Aufruf eines Unterprogramms aus einer Library funktioniert 
  35.  wie der Aufruf eines eigenen Unterprogrammes, z.B.
  36.  
  37.   LIBRARY "graphics.library"
  38.   rp&=WINDOW(8) : a$="HiSoft-BASIC Intuition-Text"
  39.   Text rp&,SADD(a$),LEN(a$))
  40.  
  41.  oder
  42.  
  43.   CALL Text(rp&,SADD(a$),LEN(a$))
  44.  
  45.  Um herauszufinden, welche Parameter übergeben werden müssen, 
  46.  schlagen Sie bitte in den ROM-Kernel-Handbüchern nach; 
  47.  alle Parameter werden als Langworte übergeben; d.h. für einige 
  48.  Aufrufe muß für Strings mit SADD die Adresse gefunden werden und 
  49.  ein CHR$(0) angefügt werden.
  50.  
  51.  Beachten Sie, daß die Namen mit denen in einigen Basic-Dialekten 
  52.  gleich sind; das Programm convertfd ändert sie, indem es ein x 
  53.  davor setzt, z.B. xREAD.
  54.  
  55.  Verwechseln Sie das nicht mit echten Maschinenaufrufen: 
  56.  die Syntax CALL LOC darf nicht in Library-Aufrufen verwendet werden.
  57.  
  58.  Beispiele für Library-Aufrufe finden Sie in GetFile auf Disk 2 
  59.  und Libraries auf der Extras-Disk.
  60.